home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: China / Acorn User China CD-ROM (UK) (Disc B) / Acorn User China CD-ROM (UK) (Disc B).bin / STUTTGART / SOUND / ATRACK / !GetSTMod_!Help < prev    next >
Encoding:
Text File  |  1991-07-26  |  4.4 KB  |  138 lines
  1. Help file for !GetSTMod
  2.  
  3. This application and code are public domain and
  4. © M. Farrow.
  5.  
  6.  !GetSTMod is intended to allow the easy conversion
  7. between tracker and amiga soundtracker format music
  8. modules on the desktop.
  9.  
  10.  To convert a module, drag it from the filer window
  11. (or another application) onto the !GetSTMod icon or
  12. the status window, and it will be loaded, and its
  13. format automatically detected.
  14.  
  15.  If a tracker module is dragged on, there is an
  16. option on the save submenu to save the tune as
  17. 'patterns'. This is intended for use with sound-
  18. tracker playback programs which use stripped
  19. modules, and the difference is that the samples are
  20. not saved on the end of the pattern data as normal.
  21.  
  22.  Once a module has been loaded in, it will remain
  23. in memory, taking up application space, until the
  24. 'clear' option is selected from the main menu. This
  25. is to allow for multiple saves without the need to
  26. load in the source module repeatedly.
  27.  
  28.  If the 'multitask' option is selected, the status
  29. window will pop up whenever a save is initiated, 
  30. (it can also be brought up by clicking on the
  31. !GetSTMod icon on the iconbar), and the module will
  32. be saved in the background. If multitasking is not
  33. selected, the hourglass icon will pop up and the
  34. module will save at a slightly faster rate as a
  35. consequence of not being interrupted.
  36.  
  37.  Whenever a file transfer of some kind is in
  38. progress, the iconbar sprite will temporarily change
  39. to a red icon to indicate the fact.
  40.  
  41.  When converting a tracker module to a soundtracker
  42. module, there are certain restrictions owing to the
  43. limited format of soundtracker modules. The sound-
  44. tracker format only allows a maximum of 4 channels
  45. to be used, so if a tune uses more than 4, only the
  46. first 4 will be converted.
  47.  The tracker format allows patterns to be any length
  48. from 1-64 events, whereas the soundtracker format
  49. can only cope with a pattern length of 64 events.
  50. If the conversion routines find a pattern of less
  51. than 64 events, it will insert a 'B' command on the
  52. last note on the relevant line, and pad out the
  53. pattern with zeroes. This is only a problem if the
  54. last note on the relevant line had a different
  55. command already there, in which case it will be
  56. overwritten.
  57.         
  58.  
  59.  
  60.  If you experience any problems while using this
  61. piece of software, or have any comments you wish to
  62. make, feel free to get in touch with me by any of
  63. the contacts listed at the end of this text file.
  64.  
  65.  
  66.  
  67. Copyright note
  68. --------------
  69. This application can only be distributed for free
  70. (with the exception of a small charge for disc and
  71. handling etc.), and can only be further distributed
  72. with all the files present and unchanged. Copying
  73. this application for commercial use, or duplicating
  74. parts of the code is not permitted unless permission
  75. is obtained from me beforehand.
  76.  If you are going to distribute this application on
  77. a large scale, I would still like to be informed so
  78. I can keep a record of what has been distributed
  79. where (in case I make any major updates/find major
  80. bugs [!])         
  81.  
  82.  
  83. Previous versions
  84. -----------------
  85. 2.00   Completely rewritten in machine code
  86.        Impression-style windows (not a very clever
  87.        way of doing it though..)
  88.        Will convert soundtracker tunes to tracker
  89.        tunes, as well as vice versa.
  90.        Multi-tasking saves
  91.        Takes up a minimum of space (about 32K) when
  92.        not in use, expanding its memory when it
  93.        needs to.
  94.        Will now cope with (and attempt to remedy)
  95.        more or less than 4 channels, and variable
  96.        pattern lengths.
  97.        Volume conversion tables slightly changed
  98.        to compensate for the non-linear archimedes
  99.        sound system.
  100.  
  101. 2.01   Fixed bug where sometimes only 15 instead of
  102.        31 samples were converted going from tracker
  103.        to soundtracker format.
  104.        Previous versions crashed if you tried to
  105.        save soundtracker conversions twice.
  106.        Option for multitasking added.
  107.  
  108. 2.02   Buttons on status window changed
  109.        General wimp interface cleaned up
  110.        Fixed small bug involving app-app transfer
  111.  
  112. 2.03   Fixed major bug introduced in version 2.02
  113.        where Tracker->Soundtracker conversions
  114.        didn't work...
  115.        Altered interpretation of soundtracker 'A'
  116.        command so that volume slides up now work.
  117.  
  118. You can contact me on:-
  119.  Arcade BBS [081-654 2212] (as Matthew Farrow)
  120.  Prestel (mbx 816706758)
  121.  Post: 45 Alleyn Park,
  122.        Dulwich,
  123.        London, SE21 8AT
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137. If this text has just scrolled by unreadably, try
  138. loading up !Edit first.